#ifndef NETWORK_HANDLER_H      // 防止头文件重复包含
#define NETWORK_HANDLER_H

#include <WiFi.h>              // WiFi 控制库
#include <Preferences.h>       // 用于保存 WiFi SSID、密码
#include <AsyncUDP.h>          // UDP 通信库

// ===================== 主功能接口 =====================
void initNetwork();            // 初始化网络模块（自动连接或启动AP）
void handleNetworkLoop();      // 处理网络循环（UDP广播、按键检测）
void doFullWifiEraseOnBoot();  // 开机检查是否需要清除WiFi配置
void pollWifiEraseButtonFull();// 检测长按按键触发WiFi清除

// ===================== 内部辅助函数（可选） =====================
bool waitForWiFiReady(uint32_t timeout_ms = 2000);  // 等待WiFi栈就绪（可选）

#endif  // NETWORK_HANDLER_H
